home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 19 / CU Amiga Magazine's Super CD-ROM 19 (1998)(EMAP Images)(GB)[!][issue 1998-02].iso / CUCD / Utilities / Scion / ARexx / ReadMe < prev    next >
Text File  |  1997-11-04  |  29KB  |  633 lines
  1. ***************************************************************************
  2. *                                                                         *
  3. *   The ARexx scripts and programs included with this distribution of     *
  4. *   Scion are the work of Scion users. If you wish to discuss these       *
  5. *   scripts and programs or make suggestions, please CONTACT THE AUTHORS  *
  6. *   DIRECTLY.                                                             *
  7. *                                                                         *
  8. ***************************************************************************
  9.  
  10. Please note that ALL scripts and programs are supplied AS IS, and no
  11. guarantees are made.  Note also that some of the scripts that involve a
  12. graphical user-interface may require the use of additional libraries (not
  13. supplied) and may be designed for PAL video screens only.
  14.  
  15. Most of these ARexx scripts and programs will work with Version 4 of Scion,
  16. however some have been re-written to take advantage of the additional ARexx
  17. commands available only with Version 5.
  18.  
  19. The scripts supplied by Freddy Ariës are also covered by the conditions
  20. detailed at the end of this file. For conditions covering other scripts and
  21. programs, please refer to the supplied documentation or the ARexx scripts
  22. themselves.
  23.  
  24. The following scripts and programs are included:
  25.  
  26. -----------------------------------------------------------------------------
  27. Age.rexx
  28.    This script should tell you the Age of a person in the SCION database.
  29.    It does expect the date to be in the format DD MMM YYYY but as long as
  30.    the year is the last 4 characters, it will give you an age within 1 year.
  31.    The database must be running for this AREXX script to work.
  32.  
  33.    Author: Peter Billing, RMB 1240, Yinnar 3869, Australia
  34. -----------------------------------------------------------------------------
  35. DGen2HTML.rexx
  36.  Version 2.04 (22 Apr 1997)
  37.  
  38.    This program produces a GENDEX file and creates HTML pages for your
  39.    system. It is © Copyright 1996-1997 Terence Nichols and may be freely
  40.    distributed as Shareware. It is not and never will be Public Domain.
  41.    Persons who register by sending me (Terence Nichols) an Email message
  42.    will be eligible to receive updates as and when available.
  43.  
  44.    Please read the Licence Agreement available online at -
  45.    http://www.networx.net.au/~spinne/index.html
  46.  
  47.    Author: Terence Nichols (spinne@networx.net.au)
  48.  
  49.    NOTE: This program (and its associated documentation) is located in a
  50.          separate directory of its own.
  51. -----------------------------------------------------------------------------
  52. Dump-Fam.rexx
  53.  Version 1.1 (31 Aug 1993)
  54.    Dump the database by family, one line per family.
  55.  
  56.    Author: Ralph L Vinciguerra, 460 Summer Ave, Reading, MA 01867, USA
  57. -----------------------------------------------------------------------------
  58. Dump-Ind.rexx
  59.  Version 1.1 (31 Aug 1993)
  60.    Dump the database by individual, one line per person. This can be sorted
  61.    with the Amiga command: sort from filein to fileout colstart 24
  62.  
  63.    Author: Ralph L Vinciguerra, 460 Summer Ave, Reading, MA 01867, USA
  64. -----------------------------------------------------------------------------
  65. FamilyTree
  66.  Version 0.6 (1 June 1997)
  67.    FamilyTree is an stand-alone add on to Scion Genealogist to print out
  68.    graphical family trees.
  69.  
  70.    It is also able to display the same family tree graphic on the screen.
  71.  
  72.    If you plan to print out the family tree then you will require a graphics
  73.    capable printer and printer driver.
  74.  
  75.    FamilyTree is Copyright ©1997 Timothy Fagan.
  76.  
  77.    Please refer to FamilyTree.Guide for further information.
  78.  
  79.  Author: Timothy Fagan (tfagan@kpmg.com)
  80.  
  81.  NOTES: (1) Even though FamilyTree is a stand-alone program and NOT an
  82.             ARexx program, it does interface with Scion via its ARexx port.
  83.         (2) The graphics printout can take some time - please be patient.
  84. -----------------------------------------------------------------------------
  85. FixLastNames.rexx
  86.    This script should FIND and REPLACE a given LAST name in the SCION
  87.    database.
  88.  
  89.    Author: Peter Billing, RMB 1240, Yinnar 3869, Australia
  90. -----------------------------------------------------------------------------
  91. FixPlaceNames.rexx
  92.    This script should FIND and REPLACE a given PLACE name in the SCION
  93.    database. It will check Birth, Death, Burial and Marriage place names.
  94.  
  95.    Author: Peter Billing, RMB 1240, Yinnar 3869, Australia
  96. -----------------------------------------------------------------------------
  97. GEDCOM2Scion.rexx
  98.  Version 2.32 (30 Oct 1997)
  99.  
  100.   This program was created to import GEDCOM data into the Scion database.
  101.   It should work pretty good by now, although no guarantees whatsoever
  102.   are made. If you have problems using this script, please contact Freddy
  103.   Ariës, and describe exactly what the problem is, or better yet, send Freddy
  104.   a copy of the GEDCOM file you are trying to read, and he will try to fix it.
  105.  
  106.   GEDCOM was developed by the Family History Department of the Church of
  107.   Jesus Christ of Latter-day Saints to provide a flexible uniform format
  108.   for exchanging computerized genealogical data.  GEDCOM is an acronym for
  109.   GEnealogical Data Communication.  GEDCOM is provided to foster the
  110.   sharing of genealogical information and the development of a wide range
  111.   of inter-operable software products to assist genealogists, historians,
  112.   and other researchers.
  113.  
  114.   + SCION must be running for this AREXX script to work.
  115.   + This script uses (by default) the rexxreqtools.library (which requires
  116.     a version of reqtools larger than 2.0 and rexxsyslib.library).
  117.     If you do not have these, run SetDefaults.rexx to change the settings.
  118.   + Even though this script does no parsing of dates, it's safer if they
  119.     are in the exact format "DD MMM YYYY".
  120.  
  121.   All unrecognized fields or fields that Scion doesn't use, are skipped.
  122.  
  123.   NOTES:
  124.   + The program generates a file FILENAME.log (where FILENAME is the
  125.     name of the GEDCOM file read), in the directory where the GEDCOM file
  126.     is located. This .log file contains parsing info about which lines were
  127.     skipped and which non-fatal errors were encountered. It may be a good
  128.     idea to read this file!
  129.   + FAMS and FAMC fields, and EVEN structures will always be skipped,
  130.     because I use another method of establishing family (spouse & children)
  131.     relationships. If no relationships are established, this probably means
  132.     that the imported file does not support that other method. If you
  133.     encounter such a file, please send it to me, and tell me what program
  134.     generated it. If this happens a lot, I will add support for the parsing
  135.     of these relations in a future version.
  136.   + If you see strange strings in the Reference fields (eg. something like
  137.     "R1"), you may be able to find more reference information in the GEDCOM
  138.     file in the SOUR structure with that reference number (eg. @R1@).
  139.  
  140.    See also SetDefaults.rexx
  141.  
  142.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  143. -----------------------------------------------------------------------------
  144. Help.rexx
  145.  Version 1.21 (12 Oct 1997)
  146.  
  147.    Just a simple menu, for those who can't remember under which function
  148.    key they have stored a certain function.
  149.  
  150.    This script will output a requester on the Scion window, in which it
  151.    will display the current settings of Scion's function keys.
  152.    It requires a version of Scion Genealogist >= 4.04.
  153.  
  154.    This script uses (by default) the rexxreqtools.library (which requires
  155.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  156.    If you do not have these, run SetDefaults.rexx to change the settings.
  157.  
  158.    For this script to be of any use to you, you will have to add the
  159.    NewHelp.rexx command to the list of function keys that you have set in
  160.    the ScionPrefs program (eg. under F1 or F10).
  161.  
  162.    DONE:
  163.     - added "stripstring" option, and handling of long results
  164.       (done by Robbie Akins)
  165.     - enhanced stripstring options
  166.     - now uses preference file for default settings
  167.     - added support for additional V5 fields
  168.  
  169.    See also SetDefaults.rexx
  170.  
  171.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  172. -----------------------------------------------------------------------------
  173. Links.rexx
  174.  Version 1.20 (12 Oct 1997)
  175.  
  176.    ARexx script to find unrelated family trees in the database
  177.    It will detect all family trees within the database that have no links
  178.    (spouse, parent or child links) to other present family trees.
  179.  
  180.    This version uses (by default) the rexxreqtools.library (which requires
  181.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  182.    If you do not have these, run SetDefaults.rexx to change the settings.
  183.  
  184.    DONE:
  185.     - progress indicator, using rexxarplib.library (requested by R.Akins)
  186.     - now uses preference file for default settings
  187.     - use of GETFIRSTIRN/GETNEXTIRN/GETLASTIRN commands for v5 and up
  188.  
  189.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  190.  
  191.    See also "unrelated.rexx" and SetDefaults.rexx
  192. -----------------------------------------------------------------------------
  193. PedigreeGuide.rexx
  194.    Version 1.02 (11 Jul 1996)
  195.  
  196.    An ARexx script to make an AmigaGuide hypertext in the format of a pedigree
  197.    chart based on the current IRN of an open ScionGenealogist data base.
  198.  
  199.    Derived from "Scion2Guide.rexx" by Robbie Akins.
  200.  
  201.    Author: Ron Goertz, 223 Clay Ct, Pullman, WA  99163
  202. -----------------------------------------------------------------------------
  203. PrintDescendant.rexx
  204.  Version 2.06 (25 Nov 1996)
  205.  
  206.   Output options:
  207.    1. Descendant Chart - all descendants [Dutch: parenteel]
  208.    2. Descendant Chart - male descendants (mention daughters, no children)
  209.       [Dutch: genealogie - nageslacht van zonen, maar vermelding dochters]
  210.    3. Descendant Chart - male descendants (leave out daughters)
  211.       [Dutch: stamboom - nageslacht van zonen, geen vermelding dochters]
  212.  
  213.   This script uses (by default) the rexxreqtools.library (which requires
  214.   a version of reqtools larger than 2.0 and rexxsyslib.library)
  215.   If you do not have these, run SetDefaults.rexx to change the settings.
  216.  
  217.   As of v2 of this script, and Scion V4, the current person on Scion's
  218.   Personal Window will be used to determine where the search starts.
  219.   Scion 3.13 can still be used, though, in which case the user will be
  220.   asked at which IRN he wants to start.
  221.  
  222.   DONE:
  223.    - Now uses preference file for default settings
  224.    - count the number of lines output and give a linefeed after a certain
  225.      number (ie. skip page breaks)
  226.    - Inclusion of name/address data from prefs (optional)
  227.  
  228.   See also SetDefaults.rexx
  229.  
  230.   Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  231. -----------------------------------------------------------------------------
  232. PrintPedigree.rexx
  233.  Version 2.08 (25 Nov 1996)
  234.  
  235.   Output options:
  236.    1. Pedigree Chart - male ancestor line only [Dutch: stamreeks]
  237.    2. Pedigree Chart - all ancestors, no siblings [Dutch: kwartierstaat]
  238.    3. Pedigree Chart - all ancestors, only siblings of last generation
  239.    4. Pedigree Chart - all ancestors, all siblings
  240.  
  241.   This script uses (by default) the rexxreqtools.library (which requires
  242.   a version of reqtools larger than 2.0 and rexxsyslib.library)
  243.   If you do not have these, run SetDefaults.rexx to change the settings.
  244.  
  245.   As of v2 of this script, and Scion V4, the current person on Scion's
  246.   Personal Window will be used to determine where the search starts.
  247.   Scion 3.13 can still be used, though, in which case the user will be
  248.   asked at which IRN he wants to start.
  249.  
  250.   So why this PrintPedigree script when Scion already has a print option
  251.   for pedigree charts? Well, the reason is simple: the format of the
  252.   pedigree charts generated by Scion does not conform to the guidelines
  253.   of the Dutch CBG (Central Bureau for Genealogy) and NGV (Nederlandse
  254.   Genealogische Vereniging; Dutch Genealogical Society). So I created my
  255.   own PrintPedigree script, that *does* follow their guidelines.
  256.  
  257.   DONE:
  258.    - Now uses preference file for default settings
  259.    - count the number of lines output and give a formfeed after a
  260.      certain number (ie. skip page breaks)
  261.    - Inclusion of name/address data from prefs (optional)
  262.  
  263.   Known Bugs/Problems:
  264.    - This script is dog slow for large databases (ie. more than, say, 10
  265.      generations), even on Amigas with a Turboboard!
  266.    - Incorrect assumptions may be made (with regard to father/mother) when
  267.      there are persons in the database whose sex-field has value '?'
  268.  
  269.    See also SetDefaults.rexx
  270.  
  271.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  272. -----------------------------------------------------------------------------
  273. Scion2GEDCOM.rexx
  274.  Version 2.45 (24 Oct 1997)
  275.    This program was created to export the Scion data into the GEDCOM file
  276.    format. It should work pretty good by now, although no guarantees
  277.    whatsoever can be given. If you have any problems using this script,
  278.    please describe them to Freddy Ariës, as detailed as possible (and
  279.    please also tell him what program you are using to read the GEDCOM file),
  280.    then he will try to work out a solution.
  281.  
  282.    GEDCOM was developed by the Family History Department of the Church of
  283.    Jesus Christ of Latter-day Saints to provide a flexible uniform format
  284.    for exchanging computerized genealogical data.  GEDCOM is an acronym for
  285.    GEnealogical Data Communication.  GEDCOM is provided to foster the
  286.    sharing of genealogical information and the development of a wide range
  287.    of inter-operable software products to assist genealogists, historians,
  288.    and other researchers.
  289.  
  290.    + SCION must be running for this AREXX script to work.
  291.    + This script uses (by default) the rexxreqtools.library (which requires
  292.      a version of reqtools larger than 2.0 and rexxsyslib.library)
  293.      If you do not have these, run SetDefaults.rexx to change the settings.
  294.    + Dates should be in English, and in the format "DD MMM YYYY" or
  295.      "DD-MMM-YYYY", if you don't want any problems with programs importing
  296.      the GEDCOM data.
  297.      If the dates in your database are not in English, please run the
  298.      Translate.rexx script first!
  299.  
  300.    See also SetDefaults.rexx
  301.  
  302.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  303. -----------------------------------------------------------------------------
  304. Scion2Guide.rexx
  305.  Version 1.01 (31 Oct 1995)
  306.  
  307.    NOTE: The script "Scion2html.rexx" by Harold Ipolyi now supercedes this
  308.          programme.
  309.  
  310.    An ARexx script to make ".guide" hypertexts from Scion Genealogist
  311.    databases. It will create not only a "guide" based representation of
  312.    a family tree, but will also provide buttons to note files and pictures
  313.    as long as the notes and pictures are in the same directory as the
  314.    database.
  315.  
  316.    Friendly warning: You'll need lots of disk space for the output!
  317.  
  318.    This version uses (by default) the rexxreqtools.library (which requires
  319.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  320.    If you do not have these, you need to supply the NOREQ argument (for
  321.    Shell output).
  322.  
  323.    Inspired by and derived from "Scion2html.rexx" by Harold H. Ipolyi (see
  324.    below). Also with assistance from Freddy Ariës.
  325.  
  326.    See also "Scion2html.rexx" by Harold H. Ipolyi which now has the ability
  327.    to generate .guide files.
  328.  
  329.    Thanks for doing all the HARD work, guys!
  330.  
  331.    NOTE: This is version 1 and requires a lot more work. Especially
  332.          support for the new fields available with Scion version 4,
  333.          and to remove some redundant code. See "Scion2html.rexx" instead.
  334.  
  335.    DONE: now uses preference file for default settings, and
  336.          improved public screen support (both by Freddy Ariës)
  337.  
  338.    See also SetDefaults.rexx
  339.  
  340.    Author: Robbie Akins
  341. -----------------------------------------------------------------------------
  342. Scion2html.rexx
  343.  Version: 30 Mar 1997
  344.  
  345.    ARexx script to make html and amigaguide hypertexts from Scion Genealogist
  346.    data bases. Also produces an ASCII text file from the database.
  347.  
  348.    PREREQUISITES: Scion V 4.07+ © Rob Akins
  349.           ARexx (of course :)
  350.           rexxsupport.library
  351.           rexxarplib.library
  352.           HTML/WWW browser (AMosaic, Mosaic, ... )
  353.  
  354.      also:     (to incorporate and display in-line pictures)
  355.          GfxCon V1.7+ © Dirk Farin ( must be in: Sys:Tools)
  356.          Amiga OS 3.0+ for displaying picture datatypes
  357.  
  358.    TESTED:
  359.     |¯¯¯¯¯¯¯¯¯¯¯¯¯|    on Amiga3000 Kickstart v.37.175 Workbench v.38.35
  360.     |    assume   |    &  Amiga3000 Kickstart v.40.68  Workbench v.40.42
  361.     |  TradeMarks |    w/ ScionGenealogist V 3.06 & Mosaic1.2NoNet
  362.     |      &      |    w/ ScionGenealogist V 3.13 & Mosaic1.3betaAmitcp
  363.     |  CopyRights |    w/ ScionGenealogist V 4.07 & Mosaic2.0Prerelease
  364.     |     as      |
  365.     | appropriate |    HTML file compatibility tested on: AMosaic, Ibrowse_demo,
  366.     |_____________|    HotJava, NCSA Mosaic (Sun), Netscape (Sun), Netscape (Mac)
  367.  
  368.    BUGS:
  369.         Scion2html.rexx only recognizes the first Scion ARexx port name:
  370.         "SCIONGEN". If additional copies of Scion are running concurrently,
  371.         they are ignored.
  372.  
  373.         If a new Thumbnail format is selected, the user must manually edit
  374.         the Picture Album files to reflect the new Thumbnail suffixes.
  375.  
  376.         The Picture Album files may have been  User  modified (and must
  377.         therefore be protected against auto-regeneration)
  378.  
  379.    Author: Harold H. Ipolyi, P.O.Box 891206, Houston, Tx 77289-1206, USA.
  380. -----------------------------------------------------------------------------
  381. ScionBrowser (Copyright © 1997 by Frank Schnell)
  382.  Version 1.0
  383.  
  384.     +---------------------------------------------------------------+
  385.     | If you intend to use this program, the author requires simple |
  386.     | registration. See the accompanying documentation for details. |
  387.     +---------------------------------------------------------------+
  388.  
  389.   Provides a graphical representation of the family of a selected person
  390.   giving the user the capability to browse through the complete database
  391.   by virtue of double-clicks on persons. As a person gets double-clicked
  392.   the whole family tree will be updated to show the family of this new
  393.   person.
  394.  
  395.   Features:
  396.       ScionBrowser has been written in an operating system friendly 
  397.       way requiring as few resources as possible. The programme itself 
  398.       is only ~30 kBytes in size (excluding the size of any shared 
  399.       libraries).
  400.       
  401.       Context insensitive help.
  402.       
  403.       Completely font sensitive (I hope).
  404.       
  405.   Requirements:
  406.       Kickstart/Workbench 2.04 or higher
  407.       
  408.       Scion Genealogist 5.x or higher
  409.       
  410.       The bare minimum of required RAM is ~100 kB Chip RAM and 
  411.       ~150 kB "any" RAM to browse a 300 people database.
  412.       (of course, ScionGenealogist must be running as well ;-)
  413.  
  414.   Performance:
  415.       ScionBrowser is relatively fast. At least I cannot complain
  416.       using an A1200 with a 68030/50MHz/8MB accelerator board. 
  417.       In order to reach a good performance ScionBrowser gets parts
  418.       of the person and family data into its own memory. Basically
  419.       these are the IRNs, FGRNs and the relationships. The drawback
  420.       of this is, that it needs a little longer to start. With a
  421.       625 people, 260 Families database the startup time on my system
  422.       is 9 seconds. But this pays off during context switches. They 
  423.       virtually take no time.
  424.  
  425.   Author: Frank Schnell, De Wilderstraat 17, B-3040 Neerijse, Belgium
  426.           Email: schnell@hotmail.com
  427.  
  428.   NOTE: This is a separate "stand-alone" program, NOT an ARexx script,
  429.         but it does communicate with Scion via its ARexx port.
  430. -----------------------------------------------------------------------------
  431. SetDefaults.rexx
  432.  Version 1.02 (1 Dec 1995)
  433.  
  434.   Instead of having to edit my scripts every time I release an update,
  435.   to change the settings to your own liking, you can now just run this
  436.   script once, and all the scripts will use the created prefs file.
  437.   This means that in the future, you will never again have to do any
  438.   editing after an update !!!
  439.  
  440.   Note to other ARexx programmers: feel free to use the preferences file
  441.   (ENV:Scion/ScionRexx.prefs) for your own purposes. There are only a few
  442.   things you have to take into account:
  443.   1. Every line has to start with a unique keyword
  444.      (keywords currently in use: [NO]USEREQ, [NO]USEPROGRESS, PUBSCREEN
  445.       NOTES, LINEWIDTH and PAGESIZE)
  446.      So if you want to put all your settings on one single line, fine,
  447.      but please make sure the first word of the line is not one of the
  448.      above!
  449.   2. Please write the required lines of code for reading and writing your
  450.      settings (keywords AND options) from/to the file, and mail them to me,
  451.      for inclusion in this script. If you do not do this, your settings
  452.      will be erased from the prefs file when the user uses this script to
  453.      modify the existing settings.
  454.   3. If you put a save option in your own script, make sure it does not
  455.      modify or erase any of the other lines that are in the file.
  456.      Only this script is allowed to do that.
  457.  
  458.   IMPORTANT: This script is FREEWARE, NOT Public Domain. You can use and
  459.     distribute it freely, ie. I don't ask any money for it, but you
  460.     are not allowed to modify it. To avoid having different versions
  461.     of this script floating around, each recognizing different keywords,
  462.     (see points 1-3 above), I am the only one allowed to change it.
  463.  
  464.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  465. -----------------------------------------------------------------------------
  466. Soundex.rexx
  467.  Version 1.08 (25 Oct 1997)
  468.    Program for Scion Genealogist 4.0 and above (no guarantees are given
  469.    for lower versions). This program should ask the user for a (last)name,
  470.    and output the list of names in the current Scion database that match
  471.    the entered name, using the SOUNDEX method of name comparison.
  472.    Scion Genealogist must be running for this script to work.
  473.  
  474.    This script uses (by default) the rexxreqtools.library (which requires
  475.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  476.    If you do not have these, run SetDefaults.rexx to change the settings.
  477.  
  478.    For those who don't know what SOUNDEX is, here is a short intro:
  479.  
  480.    The Soundex system is the means established by the National Archives
  481.    to index the U.S. censuses (beginning with 1880). It codes together
  482.    surnames of the same and similar sounds but of variant spellings.
  483.    Soundexes are arranged by state, Soundex code of the surname, and
  484.    given name.
  485.  
  486.    Soundex codes begin with the first letter of the surname followed by a
  487.    three-digit code that represents the (first three) remaining consonants.
  488.    This Soundex converter will do the tricky work for you and capture the
  489.    nuances of the coding scheme (such as coding adjacent like letters as
  490.    one). Just enter the surname that you want coded.
  491.  
  492.    Soundex Coding Guide
  493.     1 = B,P,F,V
  494.     2 = C,S,G,J,K,Q,X,Z
  495.     3 = D,T
  496.     4 = L
  497.     5 = M,N
  498.     6 = R
  499.  
  500.    The letters A,E,I,O,U,Y,H and W are not coded.
  501.  
  502.    Note that surname prefixes such as Van, Von, Di, De, Le, D', dela, or
  503.    du are sometimes disregarded in alphabetizing and in coding.
  504.    Therefor it is wise to code it with and without the prefix because it
  505.    may be listed under either code. Eg. Van Hoesen could be coded as
  506.    VanHoesen or as Hoesen.
  507.  
  508.    With Version 5+ of Scion, this script can also perform Metaphone matching.
  509.    Invoke the script as "rx Soundex.rexx META" to perform Metaphone matching
  510.    instead of Soundex matching.
  511.  
  512.    DONE:
  513.     - 2 consecutive letters with the same code are now treated as one
  514.       eg. LLOYD=LOYD -> [LD=L300], and JACKSON (CKS are all 2) -> [JCN=J250]
  515.     - now uses preference file for default settings
  516.     - Use of GETFIRSTIRN/GETNEXTIRN/GETLASTIRN commands for v5 and up
  517.     - Use of v5 built-in commands for Soundex and Metaphone support
  518.     - Added progress requester
  519.  
  520.    See also SetDefaults.rexx
  521.  
  522.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  523. -----------------------------------------------------------------------------
  524. Translate.rexx
  525.  Version 1.36 (28 Oct 1995)
  526.  
  527.    You may have noticed that setting another language in Locale means that
  528.    the date (month) fields of your database are no longer recognized
  529.    correctly. This is where Translate comes in.
  530.  
  531.    It will convert all the standard language fields in a Scion database (in
  532.    v4.0+, that means the Date fields) into another (predefined) language.
  533.    Currently Dutch, German, French, Italian, Norwegian, Swedish and Finnish
  534.    are supported, but only translation to and from English is possible.
  535.    Adding other languages shouldn't be hard.
  536.  
  537.    This version uses (by default) the rexxreqtools.library (which requires
  538.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  539.    If you do not have these, run SetDefaults.rexx to change the settings.
  540.  
  541.    DONE:
  542.      - progress indicator, using rexxarplib.library
  543.      - (requested by Robbie Akins himself)
  544.      - now uses preference file for default settings
  545.  
  546.    See also SetDefaults.rexx
  547.  
  548.    Author: Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  549.  
  550.    NOTE: This program is essentially obsolete for Scion v5, but MAY be
  551.          needed to convert a "foreign language" Version 4 database BEFORE
  552.      it is loaded into Scion v5.
  553. -----------------------------------------------------------------------------
  554. Unrelated.rexx
  555.  Version 1.03 (12 Oct 1997)
  556.  
  557.    ARexx script to find "unrelated" people in the database.
  558.    That is, it will locate all those people who have no parents and who
  559.    have no marriages recorded (and hence cannot have any recorded children)
  560.  
  561.    This version uses (by default) the rexxreqtools.library (which requires
  562.    a version of reqtools larger than 2.0 and rexxsyslib.library)
  563.    If you do not have these, run SetDefaults.rexx to change the settings.
  564.  
  565.    Now uses preference file for default settings, added by Freddy Ariës
  566.  
  567.    1.02: Now uses preference file for default settings (by Freddy Ariës)
  568.    1.03: Now supports v5 commands GETFIRSTIRN/GETNEXTIRN/GETLASTIRN
  569.  
  570.    See also Links.rexx and SetDefaults.rexx by Freddy Ariës
  571.  
  572.    Author Robbie Akins + bug fix from Freddy Ariës. See also "Links.rexx"
  573. -----------------------------------------------------------------------------
  574. Witness.rexx
  575.  
  576.    Ted Wildy (NZ) is accumulating UK marriages, indexed on WITNESSES.
  577.  
  578.    This script reads your Scion Family records and tries to construct
  579.    records for inclusion in the Index, writing its output to the file
  580.    RAM:Witnesses, where you can edit it as required before submission.
  581.    Of course, the Scion database must be running for the script to work.
  582.  
  583.    The format of a single four-line file record in the existing files
  584.    (which this script tries to reproduce) is:
  585.  
  586.        Witness-Forenames   Witness-SURNAME     date        Church
  587.        Husband-Forenames   Husband-SURNAME     Town        XXX
  588.        Wife----Forenames   Wife----SURNAME     your-FHS/member-number
  589.           your full name and address (for contact)
  590.  
  591.        where XXX represents the UK County code.
  592.  
  593.    Author: David Beames (dave@beames.demon.co.uk)
  594. -----------------------------------------------------------------------------
  595.  
  596. The following note is from the author Freddy Ariës:
  597.  
  598.  
  599. My scripts are able to use the ReqTools.library, and default to that,
  600. if you have rexxreqtools.library (No, these libraries are not included
  601. here, because it would make the package too large, but they are freely
  602. distributable and should be easy to obtain).
  603.  
  604. Some of these scripts can also display a progress indicator on the screen,
  605. and default to that if rexxarplib.library is present.
  606.  
  607. If you do not want to use reqtools requesters or a progress indicator,
  608. or if you want to change any of several other default settings used in my
  609. scripts, just run the SetDefaults.rexx script.
  610. THERE'S NO MORE NEED TO EDIT THE SCRIPTS TO CHANGE THESE SETTINGS!
  611.  
  612. Please don't use these scripts as examples of good programming in ARexx!
  613. Initially they were just quick hacks for myself, not really meant for
  614. public distribution. And even though they have come to be a fixed part
  615. of the Scion distribution and have developed based on the wishes of users,
  616. basically, that just means that they're hacked up even more now than they
  617. were at the start.
  618. I do try to keep them free of bugs, though, so I would really like to hear
  619. it if you encounter any bugs, but also if you have any suggestions or
  620. comments!
  621.  
  622. My scripts are released to the PUBLIC DOMAIN, unless otherwise specified
  623. in the header of the script. This means that you can do with them whatever
  624. you want. All I ask of you is to (please) name me as the original author.
  625.  
  626. NO WARRANTIES! I do not take the responsibility for ANYTHING, including,
  627. but not limited to, the loss of data caused by any of these scripts.
  628. Everything you do with the scripts is your own responsibility, and at your
  629. own risk.
  630.  
  631. Freddy Ariës, Lindeboomweg 7, NL-7135 KE Harreveld, The Netherlands.
  632. 24 Oct 1995
  633.